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FOREWORD 


The Software Engineering Laboratory (SEL) is an organization sponsored by the 
National Aeronautics and Space Administration/Goddard Space Flight Center 
(NASA/GSFC) and created to investigate the effectiveness of software engineering 
technologies when applied to the development of applications software. The SEL was 
created in 1976 and has three primary organizational members: 

NASA/GSFC, Systems Development Branch 

University of Maryland, Department of Computer Science 

Computer Sciences Corporation, Systems Development Operation 

The goals of the SEL are (1) to understand the software development process in the 
GSFC environment; (2) to measure the effect of various methodologies, tools, and 
models on this process; and (3) to identify and then to apply successful development 
practices. The activities, findings, and recommendations of the SEL are recorded in the 
Software Engineering Laboratory Series, a continuing series of reports that includes 
this document. 

The major contributor to this document is 

David Kistler (Computer Sciences Corporation) 

Additionally, the following person contributed significantly: 

Kellyann Jeletic (GSFC) 

Single copies of this document can be obtained by writing to 

Systems Development Branch 
Code 552 

Goddard Space Flight Center 
Greenbelt, Maryland 20771 
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ABSTRACT 


I This document contains installation information for the Software Management Envi- 
' ronment (SME), developed for the Systems Development Branch (Code 552) of the 
Flight Dynamics Division of Goddard Space Flight Center (GSFC). The SME provides 
' an integrated set of management tools that can be used by software development man- 
’ agers in their day-to-day management and planning activities. This document provides 
a list of hardware and software requirements as well as detailed installation instructions 
-and trouble-shooting information. 
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SECTION 1— DOCUMENT OVERVIEW 


The Software Management Environment (SME) is being developed for the Systems 
Development Branch (Code 552) of the Flight Dynamics Division (FDD) of the 
Goddard Space Flight Center (GSFC). The SME provides an integrated set of man- 
agement tools that can assist software development managers in their day-to-day man- 
agement and planning activities. 

This document contains the information you will need to install the SME software on a 
VAX computer connected to personal computer (PC) workstations. It is organized as 
follows: 

• Section 2 presents an overview of the installation procedures and summa- 
rizes the minimum hardware, software, and communications requirements 
for the SME. General restrictions and assumptions are also summarized. 

• Section 3 describes the SME directory structures as they exist on VAX com- 
puters and PC workstations, and presents a summary of the files and their 
contents. 

• Section 4 describes how to install and configure the SME software. 

• Section 5 provides troubleshooting hints for successful execution. General 
guidelines and specific anomalies are given. 

• The appendix describes the SME configuration and support files required for 
execution. 
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SECTION 2— INSTALLATION PROCEDURE OVERVIEW 


The following sections describe the hardware, software, and communications configu- 
ration you will need to install and run the SME on VAX computers and PC worksta- 
tions. General assumptions and restrictions are also presented. 

2.1 INSTALLATION OVERVIEW 

Because of the distributed architecture of the SME, there are two stages to complete 
installation: loading the VAX-resident portion of the software, and loading the PC- 
resident portion of the software. 

The VAX-resident portion of the software is distributed on a 6250 bits per inch (bpi) 
9-track tape created using the virtual memory system (VMS) backup utility. This tape 
contains all files that you will need to execute the SME. After you unload the tape onto 
the target VAX computer, the files will appear in the directory structure that the SME 
expects (Section 3.1). Section 4.1 presents step-by-step procedures for installing the 
VAX-resident portion of the SME. 

The PC-resident portion of the SME software is distributed on a 360-kilobyte (kB) 
installation diskette that was formatted under Microsoft Disk Operation System 
(MS-DOS) Version 3.3. Section 4.2 presents complete instructions for installing the 
PC-resident portion of the SME software. 

2.2 HARDWARE REQUIREMENTS 

The VAX hardware and memoryyou will need to install and run the SME are as follows: 

• VAX computer 

• Asynchronous communications port 

• 800-kB memory (peak working set size of 1500 pages) 

• 3 megabytes (MB) minimum disk storage (5 MB optimum) 

The PC hardware and memory you will need to install and run the SME: 

• IBM PC or compatible 

• Enhanced graphics adapter (EGA) color monitor 1 

• Serial communication port (ELA RS-232C) 


1 A video graphics array (VGA) color monitor may also be used for EGA graphics in VGA medium- 
resolution mode. 
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• 640-kB memory 

• 125-kB disk storage 

2.3 SOFTWARE REQUIREMENTS 

The following lists the VAX and PC software you will need to install and run the SME: 

• VAX — VMS operating system (Version 5.3 or higher) 1 

• PC — MS-DOS (Version 3.0 or higher) 

Additionally, VAX LISP must be available in order to run the SME’s expert system. 

2.4 COMMUNICATIONS REQUIREMENTS 

The following delineates the communications configuration required by the SME: 

• Support for serial asynchronous communications 

• Conformance to the EIA RS-232C communications standard 

• Interface via a hard-wired connection (i.e., data terminal equipment (DTE) 
to DTE in a “null modem configuration”) or via a modem (i.e., DTE to data 
communications equipment (DCE) to DTE) 

2.5 ASSUMPTIONS AND RESTRICTIONS 

The SME program assumes the SME user has appropriate READ, WRITE, and 
EXECUTE privileges for the directories created by the VAX SME software installa- 
tion procedure. Additionally, the user must have a disk quota for creating files on the 
disk where the SME was installed. 

The only installation-specific restriction concerns VAX user IDs. The maximum user 
ID length the current version of the SME will accept is 10 characters. 


1 The SME requires runtime support for VAX system service routines and for VAX Pascal Version 4.0. 
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SECTION 3— SME FILE DESCRIPTION 


The following sections provide an overview of the VAX and PC directory structures ex- 
pected by the SME software. The files contained in the directories are also briefly de- 
scribed. 

3.1 SME VAX DIRECTORY STRUCTURE 

All files that the SME requires at runtime are distributed logically, based on usage, in a 
hierarchy of directories. The files needed by the SME include executable images, proj- 
ect data, models, and various definitions files. Figure 3-1 shows the directory structure 
that will be created by unloading the VAX SME software (Section 4.1) onto the target 
computer. 



Figure 3-1. SME Directory Structure 


The following is a list of the directories and a brief description of their contents. The 
numbers correspond to the numbers shown in Figure 3-1. 

1. [SME] This directory contains the command files and executable images 
necessary to configure and run the SME software on the VAX. The directory 
also contains the [SME.DATA] directory. After execution of the SME, the 
[SME] directory will contain debug and user context files. As a result, users 
will require write privileges for this directory. 
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2. [SME.DATA] This directory contains the [KBASE], [LISP], [MODELS], 
[PROJECTS], and [USER] directories. 

3. [SME.DATA.KBASE] This directory contains all knowledge base files that 
define explanations, factors, and reasons used by the trend assessment func- 
tion under the SME growth monitor. 

4. [SME.DATA.LISP] This directory contains all files required by the software 
to execute the VAX LISP expert system function under the SME rate moni- 
tor. 

5. [SME.DATA.MODELS] This directory contains all models used by the 
SME at run time. The directory also contains files used to define the growth 
and profile measures used by the SME. 

6. [SME.DATA.PROJECTS] This directory contains all the sample project 
data files provided on the installation tape. 

7. [SME.DATA.USER] This directory contains the [SME.DATA.USER. 
DATA] directory and will contain all individual user directories created at 
runtime. Users will require write privileges for this directory. 

8. [SME.DATA.USER.DATA] This directory contains all project-specific sub- 
jective data files created interactively by the user at runtime. These subjec- 
tive data files are used with the knowledge base files for performing trend 
assessment under the SME growth monitor. Users will require write privi- 
leges for this directory. 

9. [SME.DATA.USER.userx] This directory contains all project -specific phase 
estimate files created interactively by the user at runtime. The phase esti- 
mate files are used with the prediction function to record the basis of each 
prediction made by the user. Users will require write privileges for this direc- 
tory. 

3.2 SME VAX FILES 

The SME requires several different types of files at program execution. The following 
sections describe these files. Additional information concerning the types of data used 
by the SME can be found in the Software Management Environment (SME) Concepts 
and Architecture (Reference 1). 

3.2.1 Executable Images 

The SME VAX software requires two executable images: SME_DRTVER.EXE and 
SME_EXEC.EXE. SME_DRTVER.EXE is simply a driver that enables the SME to 
execute either under a VAX VMS environment or under a VAX LISP environment. 
SME_EXEC.EXE functions as the executive -level driver for the system. Both execut- 
able images reside in the [SME] directory. 
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3.2.2 Compiled LISP Files 

The SME VAX software requires several compiled VAX LISP files to run the expert 
system feature. These files reside in the [SME.DATA.LISP] directory. Note: the expert 
system is only available at those sites having VAX LISP available on the target VAX. 

3.2 3 Model Files 

The model files contain information used by the SME to create “guidelines” that, when 
compared to graphically plotted project data, can give the user an indication of how the 
project being plotted is behaving with respect to a “typical” project. The models are 
sequential text files read by the SME at runtime. All model files reside in 
[SME.DATA.MODELS] and have the file extension MDL. 

3.2.4 Project Data Files 

The sample project data files provided on the installation tape contain historical data 
used by the SME to generate plots that graphically represent a project’s behavior over 
its development life cycle. The files are sequential text files that function as input to the 
SME and have the file extension DAT. All project data files reside in the directory 
[SME.DATA.PROJECTS]. A complete list of sample projects and available data for 
each project is provided with the distribution kit. 

3.2.5 Definition Files 

The SME reads a number of files at runtime to define key elements required by various 
SME functions. The files MEASURE.LST and PROFILE.LST are read at runtime to 
define the growth and profile measures used by the SME. These are sequential text 
files that reside in the directory [SME.DATA.MODELS]. Another file, 
DEFINITIONS.LST, resides in the [SME] directory and defines the functions used by 
the overall assessment feature. 

Three files define the explanations, factors, and reasons, respectively, used by the 
knowledge base: EXPLAIN.KBS, FACTOR.KBS, and REASON.KBS. These are 
also sequential text files that reside in the directory [SME.DATA.KBASE]. 

One file, INTERPRETATIONS.DAT, resides in directory [SME.DATA.LISP] and 
contains text descriptions of mnemonic codes returned by the LISP expert system func- 
tion. (This option is not available at sites that do not have VAX LISP.) 

3.2.6 Command Files 

There are three primary command files, SME.COM, SME_SETUP.COM, and 
SME_RUN.COM, all residing in the [SME] directory. SME_SETUP.COM defines a 
set of VAX logicals required by the SME at runtime, and SME_RUN.COM invokes the 
executable image. Both SME_SETUP.COM and SME_RUN.COM are invoked by 
SME.COM. 
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3 .3 SME PC FILES 


There are three EXE files in the SME directory on the PC: INSTALL.EXE, 
SME_CHAT.EXE, and PORTSTAT.EXE. INSTALL.EXE is the program provided on 
the diskette that performs the actual installation of the SME onto the hard drive of the 
target PC. SME_CHAT.EXE is the program that reads, interprets, and subsequently 
displays the information sent to the PC by the VAX. PORTSTATEXE is a utility pro- 
gram provided to help identify which PC communications port is attached to the VAX 
communications line. The PORTSTAT program’s use is further described in Sec- 
tion 4.2. 

SMESTART.BAT is a batch file that establishes the PC graphics mode and invokes the 
PC software. This file is created by the INSTALL program, described in Section 4.2. 

There are five additional support files used by the SME PC software at runtime: 
EGAVGA.BGI (a graphic device driver); and GOTH.CHR, LITT.CHR, SANS.CHR, 
and TRIP.CHR (graphic fonts). 
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SECTION 4— SME INSTALLATION AND CONFIGURATION 

PROCEDURES 


The following sections describe the procedures used to install the SME software on tar- 
get VAX and PC computers. 

4.1 VAX INSTALLATION PROCEDURE 

After mounting the SME installation tape on a 9-track 6250-bpi density tape drive, 
issue the following command (where MUAO is the local tape drive name): 

allocate MUAO: 

VMS will confirm the successful allocation with a message similar to the following: 

%DCL-I- ALLOC, _$1$MUA0: allocated 

Next, issue the following command: 

mount/foreign/density =6250 MUAO: 

VMS will respond with a confirmation message similar to the following: 

%MOUNT- 1 -MOUNTED, INSTAL mounted on _$1$MUA0: (STLH1) 

Next, unload the tape using the VMS backup utility by issuing the following command: 

backup MUAO:install.sme/save_set/select=[sme.test...] — /noassist [target 
directory...] 

The “target directory” is the directory into which you are unloading the SME installa- 
tion tape. Be sure this directory specification includes the three trailing dots. 

Finally, issue the following two commands to dismount and deallocate the tape: 

dismount MUAO: 

deallocate MUAO: 

After installing the software from the tape, you can verify that all the files were un- 
loaded successfully by referring to the listing of the tape creation log provided with the 
distribution kit. 

4.2 SME PC INSTALLATION PROCEDURE 

Insert the SME installation diskette into one of the PC disk drives. Change the default 
drive to reference the drive containing the diskette. For example, if you inserted the 
diskette in the B drive, enter the following at the DOS prompt: 

b: 
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Before proceeding, you must know two facts about the particular PC on which you are 
installing the SME: 

1. The number of the PC communications port attached to the VAX commu- 
nications line (normally 1 or 2) 

2. The baud rate of the communications line to the VAX (e.g., 4800 or 9600) 

The definitive source for this information is the PC system coordinator for your orga- 
nization. You can also use the SME PORTSTAT utility, included on the installation 
diskette, to assist in determining the appropriate number to reference the PC commu- 
nications port. To run this utility, enter: 

portstat 

For each PC communications port found, the utility generates one of the two following 
messages: 


• comX: status is HHHH 

• comX: is not present 

In these messages, X will be the port’s number (i.e., 1 or 2), and HHHH will be the 
port’s status displayed in hexadecimal. 

If one communications port is reported as not present, you may assume the other port is 
attached to the VAX communications line. Some PCs, however, have multiple commu- 
nications ports, and a status code will be reported for each port. In this case, consult the 
PC system coordinator to determine the proper port to reference. 

Once you have determined the port number and baud rate for the VAX communica- 
tions line, you can complete the installation by entering: 

install 

The INSTALL program will prompt you for the port number and baud rate before 
installing the needed SME PC software in the directory C:\SME on the hard disk. 

4.3 VAX COMMAND FILE CONFIGURATION 

Before you can execute the SME software successfully, you must resolve a few adminis- 
trative and configuration issues. 

First, you must provide all prospective SME users with VAX logon IDs, disk space 
allocation quotas, access to all SME files, and write privileges to the [SME], 
[SME.DATA.USER], and [SME.DATA.USER.DATA] directories. 

Next, you must modify the command file SME_SETUP.COM that resides in the [SME] 
directory to reference the appropriate disk name correctly. Edit the file and change all 
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occurrences of “STL_DISK1” to the name of the disk on which you placed the SME 
files. 

Finally, you must provide each user with a LOGIN.COM file that defines a logical 
“SME$SYSTEM” referencing your disk name concatenated with the [SME] directory. 
The LOGIN.COM should also define a VAX symbol “SME” that invokes the 
SME.COM file in SME$SYSTEM, so that the user can invoke the VAX portion of the 
software by entering: 

SME 

Then, if VAX LISP is available, the user will be able to invoke the SME with the expert 
system by entering: 

SME EXPERT 

Complete instructions for running the SME are provided in the Software Management 
Environment (SME) User Reference Material (Reference 1). A sample LOGIN.COM 
file is provided on the installation tape and resides in the [SME] directory as 
LOGIN USER.COM. 
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SECTION 5— TROUBLESHOOTING HINTS 


The following sections provide some procedures to follow if you encounter problems 
when running the SME software. 

5.1 GENERAL GUIDELINES 

Once you have successfully installed the SME and tested all the options, you should 
create a backup tape. In the event that something catastrophic occurs and you have to 
reinstall the software, you will be installing your own configured version. 

SME files can be edited, but with the exception of command (.COM) files, they should 
not be. Invalid characters, delimiters, or formats could inadvertently be introduced 
that would make further troubleshooting difficult if not impossible. If the files become 
hopelessly corrupted, you will probably have to reinstall the software. 

If you are a first-time SME user, upon initialization you will receive the message that 
your context file could not be read and that default values are being used. This is not an 
error. The SME software creates a context file foryou in the [SME] directory with a file 
name CONTEXT_userid.DAT. Assumingyour context file does not get deleted, subse- 
quent executions of the SME will not generate this message. Depending on the amount 
of use the SME receives, periodic purging of user context files is advised. 

5.2 SPECIFIC ANOMALIES 


The following list describes potential problems and corrective actions. 
1. Problem: SME fails to execute. 


Response: Ensure that you are in the [SME] root directory and that 

SME_DRIVER.EXE and SME_EXEC.EXE are present. 


If you entered the “expert” parameter when attempting to run 
the software, ensure that LISP is present. If LISP is not pres- 
ent, reexecute the SME without the “expert” parameter. 

2. Problem: SME fails to initialize properly (executive menu never ap- 

pears). 

Response: Refer to the table in the appendix to check the logical refer- 

ences in SME_SETUP.COM; reconfigure, if necessary. 

Ensure MEASURE.LST and PROFTLE.LST files are in the 
directory referenced by the “USRDATA” logical. 
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3. Problem: 
Response: 

4. Problem: 

Response: 

5. Problem: 

Response: 

6. Problem: 
Response: 

7. Problem: 
Response: 


SME appears to “hang” when entering the PREDICT option 
of the growth monitor. " 

Ensure that your userid has write privileges for 
[SME.DATA.USER. userid] directory. 

Ensure that your userid has a quota for creating files and that 
the quota has not been exceeded . 

Ensure that the logical “usrdata” in SME_SETUP.COM is not 
concatenated with a second logical containing a trailing dot. 

SME appears to “hang” when attempting to change a reason 
in the ASSESS option of the growth monitor. 

See response 3. 

SME appears to “hang” when entering the OVERALL 
ASSESSMENT option of the executive menu. 

Ensure that the DEFTNITIONS.LST file is in the [SME] root 
directory. ^ = y .1 : ' ’ ' F ’ 4 ' ' : 

SME generates “Unable to write context file” message upon 
exit. 

Ensure that your userid has a quota for creating files and that 
the quota has not been exceeded. 

SME appears to “hang” when generating a graph. 

Suspect corrupted data. See if any model or data file for the 
project and/or measure has a different version number 
(higher) or create date (later) than the o ther mo del or data 
files. If this is the case and the original file still exists, delete 
the newer file. If the original file does not exist (it may have 
been purged), restore the original file from a backup tape. It 
might be possible to reconstruct the file by hand, but it is highly 
unlikely. 
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APPENDIX— SUPPORT FILE REFERENCE LIST 


The SME requires that five logical references be defined at runtime, which is per- 
formed by SME_SETUP.COM. The following listing presents the “logicals” and the 
directory referenced by each logical after installation. 


Logical 

Directory 

PRJDATA 

diskname:[SME.DATA.PROJECTS] 

MDLDATA 

diskname: [SME.DATA.MODELS] 

KBSDATA 

diskname: [SME .DATA.KBASE] 

LSPDATA 

diskname: [SME.DATA.LISP] 

USRDATA 

diskname: [SME.DATA.USER] 


You may redefine the logicals to reference different directories by editing 
SME_SETUP.COM. The SME, however, expects the contents of the directories refer- 
enced by the logicals to be what is described in Section 3. For example, the models, 
MEASURE.LST, and PROFILE.LST files must reside in whatever directory is refer- 
enced by the logical MDLDATA. 

The following listing presents what the SME expects in the directories referenced by 
each logical. It is a summary of the information contained in Section 3 and is included 
as a convenience. 


Logical 

Expected Contents 

PRJDATA 

sample project data supplied with the installation tape 

MDLDATA 

all models, MEASURE.LST, PROFILE.LST 

KBSDATA 

EXPLAIN. KBS, FACTOR. KBS, REASON.KBS 

LSPDATA 

compiled (FAS) USP files, INTERPRETATIONS.DAT j 

1 USRDATA 

DATA.DIR, user. DIR 


Refer to Section 4.3 for more information on modifying the SME_SETUP.COM file. 
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GLOSSARY 


bpi 

bits per inch 

DCE 

data communications equipment 

DTE 

data terminal equipment 

EGA 

enhanced graphics adapter 

FDD 

Flight Dynamics Division 

GSFC 

Goddard Space Flight Center 

kB 

kilobyte 

MB 

megabyte 

MS-DOS 

Microsoft Disk Operating System 

PC 

personal computer 

SME 

Software Management Environment 

VGA 

video graphics array 

VMS 

virtual memory system 
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